/*
 *  Copyright (C) 2009 Antonio Mata Chamorro
 *  
 *  Este programa es software libre: usted puede redistribuirlo y/o modificarlo
 *  bajo los t�rminos de la Licencia P�blica General GNU publicada
 *  por la Fundaci�n para el Software Libre, ya sea la versi�n 3
 *  de la Licencia, o (a su elecci�n) cualquier versi�n posterior.
 *  
 *  Este programa se distribuye con la esperanza de que sea �til, pero 
 *  SIN GARANT�A ALGUNA; ni siquiera la garant�a impl�cita
 *  MERCANTIL o de APTITUD PARA UN PROP�SITO DETERMINADO. 
 *  Consulte los detalles de la Licencia P�blica General GNU para obtener 
 *  una informaci�n m�s detallada. 
 *  
 *  Deber�a haber recibido una copia de la Licencia P�blica General GNU
 *  junto a este programa. 
 *  En caso contrario, consulte <http://www.gnu.org/licenses/>.
 *   
 */
package org.javahispano.javacup.tacticas_aceptadas.amata.com.amata.javacup.tacticas;

/**
 * Interfaz a implementar por cualquier clase que pretenda eval�ar cuales son
 * los mejores puntos sobre el terreno de juego para realizar alg�na acci�n, por
 * ejemplo para pasar o tirar a puerta.
 * 
 * @author Antonio Mata Chamorro
 * */
public interface SpotCalculator {
	/**
	 * Buscar los puntos que para el jugador pasado son los mejores. El criterio
	 * de "mejores puntos" es definido por la implementaci�n
	 * 
	 * @param player
	 *            jugador desde el que se pretende encontrar los mejores puntos
	 *            para realizar alg�na acci�n (como por ejemplo un pase)
	 * @param results
	 *            despu�s de ejecutar el m�todo contendr� la lista de puntos
	 *            (con sus correspondientes valoraciones) considerados mejores.
	 *            Estos puntos se a�adir�n a los puntos ya existentes en la
	 *            variable results
	 * */
	public void findSpots(SoccerPlayer player, SpotResults results);
}
